<!DOCTYPE html>
<html lang="en">
	<head>
		<meta charset="utf-8" />
		<base href="../../" />
		<script src="list.js"></script>
		<script src="page.js"></script>
		<link type="text/css" rel="stylesheet" href="page.css" />
	</head>
	<body>
		<h1>[name]</h1>

		<div class="desc">
		Class representing a color.
		</div>


		<h2>Examples</h2>
		A Color can be initialised in any of the following ways:
		<code>
//empty constructor - will default white
var color = new THREE.Color();

//Hexadecimal color (recommended)
var color = new THREE.Color( 0xff0000 );

//RGB string
var color = new THREE.Color("rgb(255, 0, 0)");
var color = new THREE.Color("rgb(100%, 0%, 0%)");

//X11 color name - all 140 color names are supported.
//Note the lack of CamelCase in the name
var color = new THREE.Color( 'skyblue' );

//HSL string
var color = new THREE.Color("hsl(0, 100%, 50%)");

//Seperate RGB values between 0 and 1
var color = new THREE.Color( 1, 0, 0 );
		</code>



		<h2>Constructor</h2>


		<h3>[name]( [page:Color_Hex_or_String r], [page:Float g], [page:Float b] )</h3>
		<div>
		[page:Color_Hex_or_String r] - (optional) If arguments [page:Float g] and [page:Float b] are defined, the red component of the color.
		If they are not defined, it can be a [link:https://en.wikipedia.org/wiki/Web_colors#Hex_triplet hexadecimal triplet] (recommended), a CSS-style string, or another Color instance.<br />
		[page:Float g] - (optional) If it is defined, the green component of the color.<br />
		[page:Float b] - (optional) If it is defined, the blue component of the color.<br /><br />

		Note that standard method of specifying color in three.js is with a [link:https://en.wikipedia.org/wiki/Web_colors#Hex_triplet hexadecimal triplet], and that method is used
		throughout the rest of the documentation.<br /><br />

		When all arguments are defined then [page:Color_Hex_or_String r] is the red component, [page:Float g] is the green component and [page:Float b] is the blue component of the color.<br />
		When only [page:Color_Hex_or_String r] is defined:<br />
		<ul>
			<li>It can be a [link:https://en.wikipedia.org/wiki/Web_colors#Hex_triplet hexadecimal triplet] representing the color (recommended).</li>
			<li>It can be an another Color instance.</li>
			<li>It can be a CSS-style string. For example:
				<ul>
					<li>'rgb(250, 0,0)'</li>
					<li>'rgb(100%,0%,0%)'</li>
					<li>'hsl(0, 100%, 50%)'</li>
					<li>'#ff0000'</li>
					<li>'#f00'</li>
					<li>'red'</li>
				</ul>

			</li>
		</ul>
		</div>

		<h2>Properties</h2>

		<h3>[property:Boolean isColor]</h3>
		<div>
			Used to check whether this or derived classes are Colors. Default is *true*.<br /><br />

			You should not change this, as it used internally for optimisation.
		</div>

		<h3>[property:Float r]</h3>
		<div>
		Red channel value between 0 and 1. Default is 1.
		</div>

		<h3>[property:Float g]</h3>
		<div>
		Green channel value between 0 and 1. Default is 1.
		</div>

		<h3>[property:Float b]</h3>
		<div>
		Blue channel value between 0 and 1. Default is 1.
		</div>






		<h2>Methods</h2>

		<h3>[method:Color add]( [page:Color color] ) </h3>
		<div>Adds the RGB values of [page:Color color] to the RGB values of this color.</div>

		<h3>[method:Color addColors]( [page:Color color1], [page:Color color2] ) </h3>
		<div>Sets this color's RGB values to the sum of the RGB values of [page:Color color1] and [page:Color color2].</div>

		<h3>[method:Color addScalar]( [page:Number s] ) </h3>
		<div>Adds [page:Number s] to the RGB values of this color.</div>

		<h3>[method:Color clone]() </h3>
		<div>Returns a new Color with the same [page:.r r], [page:.g g] and [page:.b b] values as this one.</div>

		<h3>[method:Color copy]( [page:Color color] ) </h3>
		<div>
			Copies the [page:.r r], [page:.g g] and [page:.b b] parameters from [page:Color color] in to this color.
		</div>

		<h3>[method:Color convertGammaToLinear]() </h3>
		<div>Converts this color from gamma to linear space by squaring the values of [page:.r r], [page:.g g] and [page:.b b] ).</div>

		<h3>[method:Color convertLinearToGamma]() </h3>
		<div>Converts this color from linear to gamma space by taking the square root of [page:.r r], [page:.g g] and [page:.b b]).</div>

		<h3>[method:Color copyGammaToLinear]( [page:Color color], [page:Float gammaFactor] ) </h3>
		<div>
		[page:Color color] — Color to copy.<br />
		[page:Float gammaFactor] - (optional). Default is *2.0*.<br /><br />

		Copies the given color into this color while converting it from gamma to linear space
		by taking [page:.r r], [page:.g g] and [page:.b b] to the power of [page:Float gammaFactor].
		</div>

		<h3>[method:Color copyLinearToGamma]( [page:Color color], [page:Float gammaFactor] ) </h3>
		<div>
		[page:Color color] — Color to copy.<br />
		[page:Float gammaFactor] - (optional). Default is *2.0*.<br /><br />

		Copies the given color into this color while converting it from linear to gamma space
		by taking [page:.r r], [page:.g g] and [page:.b b] to the power of 1 / [page:Float gammaFactor].
		</div>

		<h3>[method:Boolean equals]( [page:Color color] ) </h3>
		<div>Compares the RGB values of [page:Color color] with those of this object. Returns true if they are the same, false otherwise.</div>

		<h3>[method:Color fromArray]( [page:Array array], [page:Integer offset] ) </h3>
		<div>
		[page:Array array] - [page:Array] of floats in the form [ [page:Float r], [page:Float g], [page:Float b] ].<br />
		[page:Integer offset] - An optional offset into the array.<br /><br />

		Sets this color's components based on an array formatted like [ [page:Float r], [page:Float g], [page:Float b] ].
		</div>

		<h3>[method:Integer getHex]()</h3>
		<div>Returns the hexadecimal value of this color.</div>

		<h3>[method:String getHexString]()</h3>
		<div>Returns the hexadecimal value of this color as a string (for example, 'FFFFFF').</div>

		<h3>[method:Object getHSL]( [page:Object optionalTarget] )</h3>
		<div>
			[page:Object optionalTarget] — (optional) if specified, adds h, s and l keys to the object (if not already present)
			and sets the results there. Otherwise, a new Object will be created. <br /><br />

			Convert this Color's [page:.r r], [page:.g g] and [page:.b b] values to [link:https://en.wikipedia.org/wiki/HSL_and_HSV HSL]
			format and returns an object of the form:

			<code>
				{ h: 0, s: 0, l: 0 }
			</code>

		</div>

		<h3>[method:String getStyle]()</h3>
		<div>Returns the value of this color as a CSS style string. Example: 'rgb(255,0,0)'.</div>

		<h3>[method:Color lerp]( [page:Color color], [page:Float alpha] ) </h3>
		<div>
		[page:Color color] - color to converge on.<br />
		[page:Float alpha] - interpolation factor in the closed interval [0, 1].<br /><br />

		Linearly interpolates this color's RGB values toward the RGB values of the passed argument.
		The alpha argument can be thought of as the ratio between the two colors, where 0.0 is
		this color and 1.0 is the first argument.
		</div>

		<h3>[method:Color multiply]( [page:Color color] ) </h3>
		<div>Multiplies this color's RGB values by the given [page:Color color]'s RGB values.</div>

		<h3>[method:Color multiplyScalar]( [page:Number s] ) </h3>
		<div>Multiplies this color's RGB values by [page:Number s].</div>

		<h3>[method:Color offsetHSL]( [page:Float h], [page:Float s], [page:Float l] ) </h3>
		<div>
			Adds the given [page:Float h], [page:Float s], and [page:Float l] to this color's values.
			Internally, this converts the color's [page:.r r], [page:.g g] and [page:.b b] values to HSL, adds
			[page:Float h], [page:Float s], and [page:Float l], and then converts the color back to RGB.
		</div>

		<h3>[method:Color set]( [page:Color_Hex_or_String value] ) </h3>
		<div>
		[page:Color_Hex_or_String value] - Value to set this color to.<br /><br />

		See the Constructor above for full details of what [page:Color_Hex_or_String value] can be.
		Delegates to [page:.copy], [page:.setStyle], or [page:.setHex] depending on input type.
		</div>

		<h3>[method:Color setHex]( [page:Integer hex] ) </h3>
		<div>
		[page:Integer hex] — [link:https://en.wikipedia.org/wiki/Web_colors#Hex_triplet hexadecimal triplet] format.<br /><br />

		Sets this color from a hexadecimal value.
		</div>

		<h3>[method:Color setHSL]( [page:Float h], [page:Float s], [page:Float l] ) </h3>
		<div>
		[page:Float h] — hue value between 0.0 and 1.0 <br />
		[page:Float s] — saturation value between 0.0 and 1.0 <br />
		[page:Float l] — lightness value between 0.0 and 1.0<br /><br />

		Sets color from HSL values.
		</div>

		<h3>[method:Color setRGB]( [page:Float r], [page:Float g], [page:Float b] ) </h3>
		<div>
		[page:Float r] — Red channel value between 0.0 and 1.0.<br />
		[page:Float g] — Green channel value between 0.0 and 1.0.<br />
		[page:Float b] — Blue channel value between 0.0 and 1.0.<br /><br />

		Sets this color from RGB values.
		</div>

		<h3>[method:Color setScalar]( [page:Float scalar] ) </h3>
		<div>
		[page:Float scalar] — a value between 0.0 and 1.0.<br /><br />

		Sets all three color components to the value [page:Float scalar].
		</div>

		<h3>[method:Color setStyle]( [page:String style] ) </h3>
		<div>
		[page:String style] — color as a CSS-style string.<br /><br />

		Sets this color from a CSS-style string. For example,
		"rgb(250, 0,0)",
		"rgb(100%, 0%, 0%)",
		"hsl(0, 100%, 50%)",
		"#ff0000",
		"#f00", or
		"red" ( or any [link:https://en.wikipedia.org/wiki/X11_color_names#Color_name_chart X11 color name]
		- all 140 color names are supported ).<br />

		Translucent colors such as "rgba(255, 0, 0, 0.5)" and "hsla(0, 100%, 50%, 0.5)" are also accepted,
		but the alpha-channel coordinate will be discarded.<br /><br />

		Note that for X11 color names, multiple words such as Dark Orange become the string 'darkorange' (all lowercase).
		</div>

		<h3>[method:Color sub]( [page:Color color] ) </h3>
		<div>
		Subtracts the RGB components of the given color from the RGB components of this color.
		If this results in a negative component, that component is set to zero.
		</div>

		<h3>[method:Array toArray]( [page:Array array], [page:Integer offset] ) </h3>
		<div>
		[page:Array array] - An optional array to store the color to. <br />
		[page:Integer offset] - An optional offset into the array.<br /><br />

		Returns an array of the form [ r, g, b ].
		</div>

		<h2>Source</h2>

		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
	</body>
</html>
